Cette section décrit les variables cachées et les commandes associées.
Comme leur nom l'indique, la valeur de ces variables est cachée à l'utilisateur dans l'interface et les logs. Les variables et leur valeur sont stockées dans un fichier spécifique. Le nom de la variable apparaît en ASCII, sa valeur est codée. Ces variables ne sont pas des variables d'Uproc. Elles peuvent être utilisées n'importe où dans Dollar Universe.
L'environnement logique de la Société (unienv) doit être exécuté avant l'exécution d'une des commandes ci-dessous.
La commande uxhideval INSERT crée une variable et sa valeur dans le fichier de définition des variables spécifié. Sa syntaxe est la suivante :
uxhideval [ESP] INSERT [FILE=filename] VAR=varname VAL=value
La commande uxhideval LIST liste les variables du fichier. Sa syntaxe est la suivante :
uxhideval [ESP] LIST [FILE=filename] VAR=varname
La commande uxhideval DELETE supprime une variable et sa valeur du fichier des variables. Sa syntaxe est la suivante :
uxhideval [ESP] DELETE [FILE=filename] VAR=varname
La commande uxhideval EXTRACT récupère la valeur de la variable dans la sortie standard. Sa syntaxe est la suivante :
uxhideval [ESP] EXTRACT [FILE=filename] VAR=varname
La commande uxexechidden exécute une commande en utilisant la valeur d'une ou de plusieurs variable cachées (la commande affiche le résultat de son exécution ainsi que la sortie standard de la commande passée en paramètre). Cette commande doit être exécutée dans un script d'Uproc soumis par Dollar Universe. Sa syntaxe est la suivante :
uxexechidden [FILE=filename] <commande> !HIDDEN_varname! !HIDDEN_varname!
Description des items
ESP
(Optionnel) Espace pour laquelle la commande est définie. Par défaut la valeur de la variable d'environnement S_ESPEXE sera utilisée et prendra pour valeur l'espace dans lequel le job est exécuté. Saisir :
FILE=
(Optionnel) Chemin et nom du fichier qui va contenir la définition des variables.
Lors de la première utilisation de la commande uxhideval … INSERT, le fichier est créé avec les droits de l'utilisateur qui exécute la commande.
Si cet item est utilisé dans la commande uxexechidden, il doit être placé en premier (voir exemple ci-après).
Si une commande ne peut pas accéder au fichier, elle se termine en erreur.
Format : Maximum 256 caractères pour le chemin et maximum 256 caractères pour le nom du fichier. Le chemin et le nom du fichier ne doivent contenir ni espace ni tabulation.
Défaut : le fichier hidevalues.dta situé dans le répertoire racine de la Société (UNI_DIR_DATA) est utilisé.
VAR=
Nom de la variable.
Format : Maximum 256 caractères. Le nom de la variable ne doit contenir si espace ni tabulation. Le caractère générique * peut être utilisé pour la commande uxhideval … LIST.
VAL=
Valeur de la variable. Cette valeur sera cachée à l'utilisateur.
Format : Maximum 256 caractères. La valeur de la variable ne doit contenir si espace ni tabulation.
commande
Commande à exécuter. La commande utilise en paramètre la valeur de la variable cachée citée (!HIDDEN_nom variable!) située dans le fichier de définition des variables. Une même commande peut accepter plusieurs variables cachées en paramètres.
Exemples
Crée la variable COUNTRY avec la valeur cachée New_Zealand dans le fichier $UXMGR/HiddenValues pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxhideval EXP INSERT var=COUNTRY val=New_Zealand file=$UXMGR/HiddenValues
Crée la variable DURATION avec la valeur cachée 120 dans le fichier $UXDIR_ROOT/hidevalues.dta pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxhideval EXP INSERT var=DURATION val=120
Liste toutes les variables (sans leur valeur) du fichier $UNI_DIR_DATA/hidevalues.dta pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxhideval EXP LIST var=*
Affiche dans la sortie standard la valeur de la variable DURATION si celle-ci existe dans le fichier $UXDIR_ROOT/hidevalues.dta pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxhideval EXP EXTRACT var=DURATION
Exécute la commande "sleep" avec comme paramètre la valeur de la variable cachée DURATION contenue dans le fichier par défaut pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxexechidden sleep !HIDDEN_DURATION!
Exécute la commande "/tmp/script.sh" avec comme paramètre la valeur de la variable COUNTRY contenue dans le fichier $UXMGR/HiddenValues.
$UNI_DIR_EXEC/uxexechidden file=$UXMGR/HiddenValues /tmp/script.sh !HIDDEN_COUNTRY!
Supprime la variable COUNTRY du fichier $UXMGR/HiddenValues si celle-ci existe pour l'espace d'exploitation.
$UNI_DIR_EXEC/uxhideval EXP DELETE var=COUNTRY file="$UXMGR/HiddenValues"
Affiche dans la sortie du job les deux valeurs des variables cachées, définies dans le fichier par défaut :
$UNI_DIR_EXEC/uxexechidden echo !HIDDEN_COUNTRY! - !HIDDEN_DURATION!
New_Zealand - 120